home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / qbbs / postlgra.zip / POSTLOG.DOC next >
Text File  |  1991-03-10  |  5KB  |  199 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.                         ┌─────────────────────────────┐
  11.                         │     -*-  Postlog-RA -*-     │
  12.                         └─────────────────────────────┘
  13.  
  14.                                     v1.00
  15.  
  16.                            For RemoteAccess v1.00+
  17.  
  18.                                       by
  19.  
  20.                                   Bob Ransom
  21.  
  22.                               Copyright (c) 1991
  23.                              All Rights Reserved
  24.  
  25.  
  26.           Postlog - What It Is -
  27.           --------------------
  28.  
  29.           Postlog is a little utility that will scan your
  30.           RemoteAccess system log for any messages that have been
  31.           posted, and keep a running total of how many have been
  32.           posted to each message area.  With this information,
  33.           you'll have a better idea of which of your message areas
  34.           are actually being used.
  35.  
  36.           Postlog - How To Use It -
  37.           -----------------------
  38.  
  39.           Postlog can be run from anyplace on your hard drive(s) and
  40.           requires one command line parameter.  A second command
  41.           line parameter is optional.  Syntax:
  42.  
  43.           Postlog <system log filename> [<-Opus>]
  44.  
  45.           The first parameter is your RA system log name (most often
  46.           RA.LOG).  You may optionally include a full path here or,
  47.           if you use the logfile name only, Postlog defaults to the
  48.           current director.  No checking of the RA environment
  49.           variable is done.
  50.  
  51.           The second parameter is "-Opus" (case is unimportant).
  52.           This denotes that you're using Opus-style system logs.
  53.           Postlog defaults to using FrontDoor-style logs and will do
  54.           so unless it finds "-Opus" as the *second* command line
  55.           parameter.
  56.  
  57.           Here are a couple of working examples:
  58.  
  59.           POSTLOG ra.log               ;ra.log in current dir and
  60.                                        ;FD logs.
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.           Postlog-RA v1.00 Docs                             Page 1
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.           POSTLOG c:\ra\ra.log -opus   ;ra.log in c:\ra.  Opus logs.
  75.  
  76.  
  77.           Postlog - What's Written To Disk -
  78.           --------------------------------
  79.  
  80.           When run, Postlog does it's stuff and shows the results on
  81.           the screen.  It also writes two files to disk:
  82.           Postlog.ASC, a text file suitable for BBS display showing
  83.           the same info as shown on screen, and Postlog.CTL, a
  84.           control file used internally by Postlog to keep track of
  85.           things as time goes by.  You may want to put Postlog.ASC
  86.           into your BBS textfiles area to be displayed as a bulletin
  87.           on your system.
  88.  
  89.  
  90.           Postlog - Misc. -
  91.           ---------------
  92.  
  93.           You can run Postlog on the same log over and over again if
  94.           you wish.  It uses a sort of "last processed" pointer in
  95.           the .CTL file to determine which lines of a log have been
  96.           processed and which haven't.
  97.  
  98.           Postlog will probably become confused if you switch log
  99.           types in mid-stream.  If you do want to switch, I'd
  100.           suggest at least deleting the existing system log before
  101.           running Postlog again.  It may or may not be a bad idea to
  102.           kill the Postlog.CTL file, too.
  103.  
  104.           Postlog will also become confused if run it with the wrong
  105.           type of log - i.e. set for FD logs but run on an Opus log,
  106.           and vice versa.  Your results will probably be extremely
  107.           weird.
  108.  
  109.           For those of you with good memories, yes, Postlog existed
  110.           (still exists, actually) as a QuickBBS utility.  This
  111.           version, however, is strictly for RemoteAccess because of
  112.           system log differences between the two systems.
  113.  
  114.  
  115.           Postlog - Legal -
  116.           ---------------
  117.  
  118.           Very little to say here except that Postlog is mine -- I
  119.           wrote it and I own it, but you may use it all you'd like
  120.           for free.  You may copy it and you may give it away, but
  121.           you may not sell it nor change it or its documentation
  122.           (this file).
  123.  
  124.  
  125.           Postlog - Support -
  126.           -----------------
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.           Postlog-RA v1.00 Docs                             Page 2
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.           I doubt there's much call for support given the extreme
  141.           complexity of the program.  <grin>
  142.  
  143.           Seriously, if you have problems with it, please let me
  144.           know.  I'm available via netmail (address below) or
  145.           through the RA_SUPPORT and RA_UTIL echoes.
  146.  
  147.  
  148.  
  149.           Hope you find it useful.
  150.  
  151.           -Bob Ransom
  152.            The Creative Connection BBS
  153.            Southfield, Michigan
  154.            (313) 559-9039
  155.            1:120/96.0
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.